home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / logs / tl205 / install.txt < prev    next >
Text File  |  1992-11-11  |  14KB  |  272 lines
  1. This is an extract from the user manual supplied with TurboLog. It details how
  2. to install TurboLog. For information on how to configure TurboLog, you will need
  3. to refer to the documentation in the TURBOLOG.CNF file. Registered users get a
  4. 150 page manual giving considerably more detail on configuration options and
  5. how to use the program. Unfortunately, this manual is over 1MB of data and thus
  6. too large to fit onto a demonstration distribution disk!
  7.  
  8.                               ....oooOOOooo....
  9.  
  10.  
  11. TURBOLOG INSTALLATION
  12. ~~~~~~~~~~~~~~~~~~~~~
  13.  
  14. What computer should I use?
  15. ---------------------------
  16. TurboLog will run on just about any PC or compatible. You will need a 
  17. minimum of 512k of RAM, (640k if you plan to use external databases or TSRs 
  18. such as BPQ node), A hard disk is required. TurboLog itself will only 
  19. occupy about 800kB on your disk, but the program makes frequent references 
  20. to the disk and builds log files that can become several MB in size. A fast 
  21. hard disk is a definite asset, but very significant improvements to 
  22. TurboLog's performance can be made by the use of a disk caching program 
  23. such as Smartdrv. I tend to recommend a minimum system of a 286 with around 
  24. 2MB of RAM if you envisage serious use of TurboLog for many thousands of 
  25. QSOs. TurboLog 2 will not run on a floppy only system! Sorry!
  26.  
  27. Of paramount importance is that any computer you use should be able to live 
  28. peacefully with your rig. Sprogs from the computer and a tendency to fall 
  29. over in the presence of RF are not endearing features!
  30.  
  31. Computer I/O port requirements
  32. ------------------------------
  33. To use the PacketCluster interface, you will need an absolute minimum of 
  34. one serial port. If you plan to use the transceiver interface so that you 
  35. can QSY your rig, then you will need a total of two serial ports. If you 
  36. wish to output Morse on a serial port then you'll need a third, but that 
  37. port does not need to have a separate IRQ, as interrupt handling is not 
  38. used for the Morse sender. If you wish to produce paper listings from the 
  39. report generator, then you will need to attach your printer to PRT1. 
  40. Finally, if you plan to use Morse on the printer port, and/or the 
  41. transceiver parallel interface auto-bandchange feature, or the remote 
  42. alerting facility, then you will need another printer port, PRT2.
  43.  
  44. Software Installation
  45. ---------------------
  46. TurboLog will be shipped to you on a single 3.5" 720k or a single 5.25" 
  47. 360k disc. In the following instructions, it will be assumed that you put 
  48. the distribution disk in drive A: and that your hard disk is drive C:. To 
  49. get the program and its database to fit onto a single floppy disc, it has 
  50. been necessary to use the PKZIP compression utility, so TurboLog is shipped 
  51. as a single self extracting file called TL.EXE. .
  52.  
  53. Installation on a hard disk based system
  54. ----------------------------------------
  55. Put the distribution disk in Drive A:
  56. If you do not have a previous version of TurboLog, then create a directory 
  57. for the program and then change to that directory, using the MkDir and CD 
  58. commands. 
  59.  
  60.     CD    \
  61.     MD    TURBOLOG
  62.     CD    \TURBOLOG
  63.  
  64. Otherwise, get to the directory your earlier version is loaded in. Now  type:
  65.  
  66.     A:TL        The archived files will be decompressed onto your hard 
  67.                         disk drive
  68.  
  69. (Note: if you are installing an upgrade then the PKUNZIP utility will ask 
  70. you if you want to overwrite files. You can safely answer YES.)
  71.  
  72. Once PKUNZIP has finished exploding(!) your files, you should type:
  73.  
  74.      INSTALL        This runs the TurboLog installation program.
  75.  
  76.  
  77. The installation program will then provide you with two installation 
  78. options: install new and upgrade an existing installation. If you have a 
  79. previous version of TurboLog then you should be careful to use the upgrade 
  80. option, otherwise your DXCC database will be overwritten. In the event that 
  81. you do accidentally overwrite the DXCC database, then you can recover it 
  82. for QSOs that have been logged using the DXCC rebuild facility described in 
  83. section 18. Note that the PREVDXCC.DAT file, if it exists, is in no way 
  84. affected by any installation operations.
  85.  
  86. Remove the distribution disk from A: and place it somewhere safe. You 
  87. shouldn't need it again unless your working copy becomes corrupted.
  88.  
  89. Upgrading from TurboLog version 1?
  90. ----------------------------------
  91. If you are upgrading from TurboLog version 1, there are a few of things you 
  92. need to do before anything else.
  93.  
  94. Updating your .TLG files
  95. ------------------------
  96. The format of the xxxx.TLG file has changed slightly to accomodate the 
  97. alterations to the RST and power fields. A utility is built into TurboLog 2 
  98. to convert your files automatically. To run the utility, simply get to the 
  99. logbook operations menu, and take option F8: use a different logbook file. 
  100. Now take option F1 to use an existing log file, and select each log file in 
  101. turn. As you select each one, the conversion will take place automatically, 
  102. together with a rebuild of the lof index files. Bargraphs plot the progress 
  103. of this operation which could be time consuming for large files.
  104.  
  105. Updating your QSL label definition files
  106. ----------------------------------------
  107. The format of the .LAB QSL label files has been altered slightly because of 
  108. enhancements to the QSL facilities. A conversion utility program is 
  109. provided which will be found in your TurboLog root directory. To perform 
  110. the conversion, simply get to DOS, and at the DOS prompt type CONVQSL. The 
  111. program will automatically find any .LAB files and convert them to the new 
  112. format. Note that only .LAB files that are in your DATA directory will be 
  113. converted. CONVQSL uses TURBOLOG.CNF to determine where the DATA directory 
  114. is.
  115.  
  116. Updating your TURBOLOG.CNF file
  117. -------------------------------
  118. TURBOLOG.CNF has grown considerably as a result of the many new features 
  119. that have been added in TurboLog 2. You will have to carry over the 
  120. parameters you have set in your existing TURBOLOG.CNF file across to the 
  121. new version.
  122.  
  123. Changing the BREAK parameter
  124. ----------------------------
  125. Before you run TurboLog, you are strongly recommended to set BREAK off. 
  126. This is because the Control-C key will otherwise be interpreted as a 
  127. program break by your DOS. As you will be using various control keys (not, 
  128. as it happens, control-C), and particularly as control-C has another 
  129. meaning altogether in communicating with TNCs, you might inadvertently 
  130. break out of TurboLog just as that bit of choice DX arrives, if break is 
  131. enabled.
  132.  
  133. Disable the break feature by typing, at the DOS prompt:
  134.  
  135.     BREAK OFF
  136.  
  137. You can put BREAK OFF into your AUTOEXEC.BAT file if you wish, and then you 
  138. will not need to remember to type it in each time you restart your 
  139. computer. The only implication of doing this is that other applications 
  140. cannot be made to break using control-C.
  141.  
  142.  
  143. A word about directories
  144. ------------------------
  145. Following installation, you will have three directories relating to 
  146. TurboLog, as follows.
  147.  
  148. TURBOLOG      Root Directory
  149.    DATA       Data directory
  150.    USRFILES   User files directory
  151.  
  152. TURBOLOG is the root directory and contains the .EXE file and some system 
  153. control files. If you entered different directory names during installation 
  154. then those directory names will be used instead. DATA is a sub directory of 
  155. the root directory and contains all the data files used by TurboLog. This 
  156. includes the Countries database, and your personal DXCC database, along 
  157. with help files and so on. USRFILES will, after installation, contain 
  158. nothing, but will be where your own personal files, such as your logbook 
  159. files, mail messages etc. are kept.
  160.  
  161.  
  162. Performance issues
  163. ------------------
  164. TurboLog is a large program and makes considerable use of system resources. 
  165. In particular, it requires about 380kB of normal memory and makes extensive 
  166. use of files on your hard disk. It is therefore very much in your interests 
  167. to optimise your PC's set-up.
  168.  
  169. Use of code overlays
  170. --------------------
  171. The many features supported by TurboLog have made it necessary to overlay 
  172. some of the code segments. What this means is that when you are in, say, 
  173. the Filtered DX window, the code for the Logging window is dropped out of 
  174. memory to leave more space. This means that if you switch to another 
  175. window, the code has to be brought in from disk again. In hard disk based 
  176. systems, the delay will be fairly short, and may even be nonexistent, as 
  177. TurboLog will make use of extended RAM if possible to avoid having to go to 
  178. the disk all the time. 
  179.  
  180. Another side effect of overlaying is that it takes longer to load the 
  181. program in the first place. There really is nothing I can do about this: a 
  182. large amount of code, plus all the databases all have to be read into 
  183. memory at start-up so that you can have fast access when using the program 
  184. real time. 
  185.  
  186. There are two ways in which you can dramatically improve the overlay 
  187. manager's performance. 
  188.     *    By allocating extended memory to TurboLog
  189.     *    By making use of a good disk cache program such as SMARTDRV 
  190.  
  191. Processor issues
  192. ----------------
  193. TurboLog will, in theory at least, run on any PC, PC compatible, or non-PC 
  194. running a PC emulator. However, you should recognise that this is a large 
  195. program: a lot of things are going on all at once and the CPU often has 
  196. some quite complex processing to do. In fairness, much of TurboLog is disk 
  197. bound from a performance viewpoint, but for reasonable performance, 
  198. particularly with very large logs I would suggest that the minimum 
  199. configuration should be a 286 running at around 12MHz.
  200.  
  201. Given that many current software packages, Windows, for example, run so 
  202. very much better on 386 systems upwards, you may like to seriously consider 
  203. a 386 as a more realistic baseline. With a 386 and 4MB of RAM you will be 
  204. able to run most of the current software on the market and at the same time 
  205. run TurboLog under Windows as a DOS application. If you plan to run 
  206. TurboLog under Windows, then be sure to use Windows 3.1, and make sure its 
  207. comms environment is set up properly! 
  208.  
  209. Memory issues
  210. -------------
  211. As an absolute minimum, TurboLog will just execute in 512kB machines. There 
  212. will be essentially no free space available and you will need to remove any 
  213. TSRs to make it fit. You will not be able to run BPQ code together with 
  214. TurboLog in a 512k system. If you have a 640k machine, then things are a 
  215. lot better and you will be able to run other programs (up to about 130kB 
  216. typically, such as W6GO's QSL database program, PCDB). 
  217.  
  218. If you have still more memory, then your options for system tuning start to 
  219. become more interesting. For example, TurboLog will automatically sense the 
  220. presence of free EMS memory and use it for holding the overlay file. This 
  221. avoids continual references to the disk as you navigate through the various 
  222. functions of TurboLog. You can also give consideration to running your DOS 
  223. in high memory, if the version you have will allow it. This can yield 
  224. another 80kb or so basic memory for running other applications with 
  225. TurboLog. Note, however, that this can have CPU performance implications on 
  226. less powerful systems.
  227.  
  228.  
  229. Use of disk cache programs
  230. --------------------------
  231. Because of the extensive use TurboLog makes of disk files, anything you can 
  232. do to speed up disk operations will have a profound effect on the speed of 
  233. operation of your program. Obviously the faster your basic disk access time 
  234. is, the better will be the performance, but you can cheat quite 
  235. legitimately by running a disk cache program.
  236.  
  237. The disk cache will eat up a chunk (say 1Mb) of your extended or expanded 
  238. memory. In return, it will carefully manage your disk activity, so that 
  239. frequently accessed data are always read from memory rather than from the 
  240. disk itself. Of course, the first time you access a particular bit of data, 
  241. it has to be read in, but thereafter access times will be much faster. 
  242.  
  243. The latest versions of some caching programs also feature write caching for 
  244. hard disks. This can significantly speed up write operations such as 
  245. logging a QSO. You need to give serious consideration to the implications 
  246. of using write caching: your data is not really secure until it is actually 
  247. written to the hard disk, and that might be several seconds after the 
  248. program thought it did the write! Personally, I have found the Smartdrv 
  249. write cache works fine, though I did take the precaution of writing a small 
  250. file called QRT.BAT which I call whenever I am about to turn the computer 
  251. off. All it does is to flush the write buffer and then park the disk. I've 
  252. had no problems.
  253.  
  254. Some recommendations
  255. --------------------
  256. If you have the memory (of the order of 1MB or more EMS) then go for a good 
  257. disk cache program, This will overcome all the overlay management issues, 
  258. as well as providing space for frequently used files to be held in memory. 
  259. I have personally found that the SMARTDRV program, shipped with Windows 3 
  260. is quite excellent with TurboLog, but I am sure that other programs would 
  261. be just fine too.
  262.  
  263. If you can't allow so much space, then do consider letting TurboLog have 
  264. some of your extended memory (i.e. don't have other programs using it all). 
  265. This will greatly improve TurboLog's overlay switching performance.
  266.  
  267. Finally, don't ignore the improvement that a faster basic hard disk can 
  268. give you. Hard discs are getting cheaper all the time, and you will notice 
  269. a big difference between, say, an 18ms and a 28ms disc.
  270.  
  271.  
  272.